home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 December / macformat-019.iso / Shareware City / Developers / Gnuplot 3.5 for Macintosh / docs / gnuplot.1 < prev    next >
Encoding:
Text File  |  1993-11-03  |  7.3 KB  |  282 lines  |  [TEXT/MSWD]
  1. .\" dummy line
  2. .TH GNUPLOT 1 "31 August 1990"
  3. .UC 4
  4. .SH NAME
  5. gnuplot \- an interactive plotting program
  6. .SH SYNOPSIS
  7. .B gnuplot
  8. [ X11 options ] [file ...]
  9. .br
  10. .SH DESCRIPTION
  11. .I Gnuplot
  12. is a command-driven interactive function plotting program.
  13. .PP
  14. If files are given,
  15. .I gnuplot
  16. loads each file with the
  17. .I load
  18. command, in the order specified.
  19. .I Gnuplot
  20. exits after the last file is processed.
  21. .PP
  22. Here are some of its features:
  23. .PP
  24. Plots any number of functions, built up of C operators, C library
  25. functions, and some things C doesn't have like **, sgn(), etc.  Also
  26. support for plotting data files, to compare actual
  27. data to theoretical curves.
  28. .PP
  29. User-defined X and Y ranges (optional auto-ranging), smart axes scaling,
  30. smart tic marks.
  31. .PP
  32. Labelling of X and Y axes.
  33. .PP
  34. User-defined constants and functions.
  35. .PP
  36. Support through a generalized graphics driver for
  37. AED 512,
  38. AED 767,
  39. BBN BitGraph,
  40. Commodore Amiga,
  41. Roland DXY800A,
  42. EEPIC,
  43. TeXDraw,
  44. EmTeX,
  45. Epson 60dpi printers,
  46. Epson LX-800,
  47. Fig,
  48. HP2623,
  49. HP2648,
  50. HP75xx,
  51. HPGL,
  52. HP LaserJet II,
  53. Imagen,
  54. Iris 4D,
  55. MS-DOS Kermit,
  56. Kyocera laser printer,
  57. LaTeX,
  58. NEC CP6 pinwriter,
  59. PostScript,
  60. QMS QUIC,
  61. ReGis (VT125 and VT2xx),
  62. SCO Xenix CGI,
  63. Selanar,
  64. Star color printer,
  65. Tandy DMP-130 printer,
  66. Tek 401x,
  67. Tek 410x,
  68. Vectrix 384,
  69. VT like Tektronix emulator,
  70. Unix PC (ATT 3b1 or ATT 7300),
  71. unixplot,
  72. and X11.
  73. The PC version compiled by Microsoft C
  74. supports IBM CGA, EGA, VGA, Hercules, ATT 6300,
  75. and Corona 325 graphics.
  76. The PC version compiled by Borland C++
  77. supports IBM CGA, EGA, MCGA, VGA, Hercules and ATT 6300 graphics.
  78. Other devices can be added simply, but will require recompiling.
  79. .PP
  80. Shell escapes and command line substitution.
  81. .PP
  82. Load and save capability.
  83. .PP
  84. Output redirection.
  85. .PP
  86. All computations performed in the complex domain.  Just the real part is
  87. plotted by default, but functions like imag() and abs() and arg() are
  88. available to override this.
  89. .SH X11 OPTIONS
  90. .I Gnuplot
  91. provides the \fIx11\fP terminal type for use
  92. with X servers. This terminal type is set automatically at startup if
  93. the \fBDISPLAY\fR environment variable is set, if the \fBTERM\fR environment
  94. variable is set to \fBxterm\fR, or if the \fB\-display\fR command line
  95. option is used.
  96. For terminal type \fIx11\fR, \fIgnuplot\fP
  97. accepts the standard X Toolkit options and resources such as geometry, font,
  98. and background. See the X(1) man page for a description of
  99. the options.
  100. In addition to the X Toolkit options:
  101. .PP
  102. \fB\-mono\fP forces monochrome rendering on color displays.
  103. .PP
  104. \fB\-gray\fP requests grayscale rendering on grayscale or color displays.
  105. (Grayscale displays receive monochrome rendering by default.)
  106. .PP
  107. \fB\-clear\fP requests that the window be cleared momentarily before a
  108. new plot is displayed.
  109. .PP
  110. \fB\-tvtwm\fP requests that geometry specifications
  111. for position of the window be made relative to the currently displayed
  112. portion of the virtual root.
  113. .PP
  114. These options may also be controlled with resources in your \fB.Xdefaults\fR
  115. file.
  116. For example: \fBgnuplot*gray: on\fP .
  117. .PP
  118. \fIGnuplot\fP provides a command line option (\fB\-pointsize \fIv\fR) and
  119. a resource (\fBgnuplot*pointsize: \fIv\fR) to control the size of points
  120. plotted with the "points" plotting style. The value \fIv\fR is a real
  121. number (greater than 0 and less than or equal to ten) used as a
  122. scaling factor for point sizes. For example, \fB\-pointsize 2\fR uses
  123. points twice the default size, and \fB\-pointsize 0.5\fR uses points
  124. half the normal size.
  125. .PP
  126. For monochrome displays, \fIgnuplot\fR does not honor foreground or
  127. background colors. The default is black-on-white. \fB\-rv\fP or
  128. \fBgnuplot*reverseVideo: on\fP requests white-on-black.
  129. .PP
  130. For color displays \fIgnuplot\fP honors
  131. the following resources (shown here with default values). The values
  132. may be color names in the X11 rgb.txt file on your system, hexadecimal
  133. RGB color specifications (see X11 documentation), or a color name
  134. followed by a comma and an \fIintensity\fR value from 0 to 1. For example,
  135. \fBblue,.5\fR means a half intensity blue.
  136. .sp
  137. .B  "gnuplot*background: white"
  138. .br
  139. .B  "gnuplot*textColor: black"
  140. .br
  141. .B  "gnuplot*borderColor: black"
  142. .br
  143. .B  "gnuplot*axisColor: black"
  144. .br
  145. .B  "gnuplot*line1Color: red"
  146. .br
  147. .B  "gnuplot*line2Color: green"
  148. .br
  149. .B  "gnuplot*line3Color: blue"
  150. .br
  151. .B  "gnuplot*line4Color: magenta"
  152. .br
  153. .B  "gnuplot*line5Color: cyan"
  154. .br
  155. .B  "gnuplot*line6Color: sienna"
  156. .br
  157. .B  "gnuplot*line7Color: orange"
  158. .br
  159. .B  "gnuplot*line8Color: coral"
  160. .br
  161.  
  162. When \fB\-gray\fP is selected, \fIgnuplot\fP honors
  163. the following resources for grayscale or color displays (shown here with
  164. default values). Note that the default background is black.
  165. .sp
  166. .B  "gnuplot*background: black"
  167. .br
  168. .B  "gnuplot*textGray: white"
  169. .br
  170. .B  "gnuplot*borderGray: gray50"
  171. .br
  172. .B  "gnuplot*axisGray: gray50"
  173. .br
  174. .B  "gnuplot*line1Gray: gray100"
  175. .br
  176. .B  "gnuplot*line2Gray: gray60"
  177. .br
  178. .B  "gnuplot*line3Gray: gray80"
  179. .br
  180. .B  "gnuplot*line4Gray: gray40"
  181. .br
  182. .B  "gnuplot*line5Gray: gray90"
  183. .br
  184. .B  "gnuplot*line6Gray: gray50"
  185. .br
  186. .B  "gnuplot*line7Gray: gray70"
  187. .br
  188. .B  "gnuplot*line8Gray: gray30"
  189. .br
  190.  
  191. \fIGnuplot\fP honors the following resources for setting the width in
  192. pixels of plot lines (shown here with default values.) 0 or 1 means
  193. a minimal width line of 1 pixel width. A value of 2 or 3 may
  194. improve the  appearance of some plots.
  195. .sp
  196. .br
  197. .B  "gnuplot*borderWidth: 2"
  198. .br
  199. .B  "gnuplot*axisWidth: 0"
  200. .br
  201. .B  "gnuplot*line1Width: 0"
  202. .br
  203. .B  "gnuplot*line2Width: 0"
  204. .br
  205. .B  "gnuplot*line3Width: 0"
  206. .br
  207. .B  "gnuplot*line4Width: 0"
  208. .br
  209. .B  "gnuplot*line5Width: 0"
  210. .br
  211. .B  "gnuplot*line6Width: 0"
  212. .br
  213. .B  "gnuplot*line7Width: 0"
  214. .br
  215. .B  "gnuplot*line8Width: 0"
  216. .br
  217.  
  218. \fIGnuplot\fP honors the following resources for setting the dash style
  219. used for plotting lines.  0 means a solid line. A 2 digit number \fIjk\fR
  220. (\fIj\fP and \fIk\fP are >= 1  and <= 9) means a dashed line with a
  221. repeated pattern of \fIj\fR pixels on followed by \fIk\fR pixels off.
  222. For example, '16' is a "dotted" line with 1 pixel on followed by 6 pixels
  223. off.  More elaborate on/off patterns can be specified with a 4 digit value.
  224. For example, '4441' is 4 on, 4 off, 4 on, 1 off. The default values shown
  225. below are for monochrome displays or monochrome rendering on color or
  226. grayscale displays. For color displays, the defaults for all are 0
  227. (solid line) except for \fBaxisDashes\fR which defaults to a '16' dotted
  228. line.
  229. .sp
  230. .br
  231. .B  "gnuplot*borderDashes: 0"
  232. .br
  233. .B  "gnuplot*axisDashes: 16"
  234. .br
  235. .B  "gnuplot*line1Dashes: 0"
  236. .br
  237. .B  "gnuplot*line2Dashes: 42"
  238. .br
  239. .B  "gnuplot*line3Dashes: 13"
  240. .br
  241. .B  "gnuplot*line4Dashes: 44"
  242. .br
  243. .B  "gnuplot*line5Dashes: 15"
  244. .br
  245. .B  "gnuplot*line6Dashes: 4441"
  246. .br
  247. .B  "gnuplot*line7Dashes: 42"
  248. .br
  249. .B  "gnuplot*line8Dashes: 13"
  250. .br
  251. .PP
  252. The size or aspect ratio of a plot may be changed by resizing the
  253. .I gnuplot
  254. window.
  255. .SH AUTHORS
  256. Thomas Williams, Pixar Corporation,
  257. .br
  258. (info-gnuplot@dartmouth.edu)
  259. .br
  260. and Colin Kelley.
  261. .PP
  262. Additions for labelling by Russell Lang, Monash University, Australia.
  263. .br
  264. (rjl@monu1.cc.monash.edu.au)
  265. .br
  266. Further additions by David Kotz, Dartmouth College, New Hampshire, USA
  267. (formerly of Duke University, North Carolina, USA).
  268. .br
  269. (David.Kotz@Dartmouth.edu)
  270. .SH BUGS
  271. The atan() function does not work correctly for complex arguments.
  272. .br
  273. The bessel functions do not work for complex arguments.
  274. .br
  275. See the
  276. .I help bugs
  277. command in gnuplot.
  278. .SH SEE ALSO
  279. See the printed manual or the on-line help for details on specific commands.
  280. .br
  281. X(1).
  282.